Skip to content

refactor: canister ID generation#10046

Open
mraszyk wants to merge 4 commits intomasterfrom
mraszyk/generate-new-canister-id
Open

refactor: canister ID generation#10046
mraszyk wants to merge 4 commits intomasterfrom
mraszyk/generate-new-canister-id

Conversation

@mraszyk
Copy link
Copy Markdown
Contributor

@mraszyk mraszyk commented Apr 28, 2026

This PR refactors canister ID generation into two phases:

  • "peeking" the (next) canister ID yields the next canister ID for canister creation (without mutating ReplicatedState);
  • "committing" that canister ID updates ReplicatedState to record that the canister ID is used now (after successful canister creation).

The motivation for this change is a follow-up refactoring that combines canister settings validation and updates (to make the code more robust and avoid potential panics), but that requires ability to derive a canister ID without actually consuming it (currently canister settings are first validated, then a canister ID is consumed, and finally canister state with validated settings is created, but that separation of settings validation and application is fragile and subject to a follow-up refactoring).

@mraszyk mraszyk marked this pull request as ready for review April 28, 2026 17:51
@mraszyk mraszyk requested review from a team as code owners April 28, 2026 17:51
Copy link
Copy Markdown
Contributor

@github-actions github-actions Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This pull request changes code owned by the Governance team. Therefore, make sure that
you have considered the following (for Governance-owned code):

  1. Update unreleased_changelog.md (if there are behavior changes, even if they are
    non-breaking).

  2. Are there BREAKING changes?

  3. Is a data migration needed?

  4. Security review?

How to Satisfy This Automatic Review

  1. Go to the bottom of the pull request page.

  2. Look for where it says this bot is requesting changes.

  3. Click the three dots to the right.

  4. Select "Dismiss review".

  5. In the text entry box, respond to each of the numbered items in the previous
    section, declare one of the following:

  • Done.

  • $REASON_WHY_NO_NEED. E.g. for unreleased_changelog.md, "No
    canister behavior changes.", or for item 2, "Existing APIs
    behave as before.".

Brief Guide to "Externally Visible" Changes

"Externally visible behavior change" is very often due to some NEW canister API.

Changes to EXISTING APIs are more likely to be "breaking".

If these changes are breaking, make sure that clients know how to migrate, how to
maintain their continuity of operations.

If your changes are behind a feature flag, then, do NOT add entrie(s) to
unreleased_changelog.md in this PR! But rather, add entrie(s) later, in the PR
that enables these changes in production.

Reference(s)

For a more comprehensive checklist, see here.

GOVERNANCE_CHECKLIST_REMINDER_DEDUP

@mraszyk mraszyk dismissed github-actions[bot]’s stale review April 28, 2026 17:52

No canister behavior changes.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant